Inside Macintosh: QuickTime Components

A Sample Movie Import Component

This section describes how to create a movie import component. First you implement the required functions. Then you instruct your component to obtain the movie data from a handle or a file. This section then supplies a sample program that implements a movie data exchange component that imports a Scrapbook file containing QuickDraw PICT images. (For details on QuickDraw PICT images, see the chapter "Basic QuickDraw" in Inside Macintosh: Imaging .)

Your movie data import component may provide a user dialog box. You may use this dialog box in any way that is appropriate for your component--for example, to obtain certain parameter information governing the import operation, such as the image-compression method.

In addition, the requesting application may use one or more of the configuration functions to establish parameters for the import operation.

You should not rely on any outside configuration information. Your component should work properly knowing only the source data and the target movie. The Movie Toolbox supplies this information to your component when it calls your MovieImportHandle function (described on [link] ) or MovieImportFile function (described on [link] ).

Your movie data import component may implement either one or both of these functions, which allow the Movie Toolbox to request that data be converted into a format for use in a QuickTime movie.

If the data is to be imported from a handle, the MovieImportHandle function is used.
If data is to be imported from a file, the MovieImportFile function is used.

Set the appropriate flags in your component's componentFlags field to indicate which of these functions your component supports. Note that your component may support both functions.

Implementing the Required Import Component Functions

Importing a Scrapbook File